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Introduction 



The two basic methods to pass parameters to the main()-routine are: 
input files and command line arguments. For small scale programs these 
input methods allow to change parameters without having to recompile or 
having to create an input file parser. Even for large programs input files 
and command line arguments are a comfortable way to replace annoying 
graphical user interfaces. When debugging complicated code, it is essential 
to be able to isolate code fragments into a lonely main()-routine. In order 
to feed these isolated code fragments with realistic data, sophisticated com- 
mand line and input le parsing becomes indispensable (excerpt from GetPot 
documentation) . 

Part I 

Requirements 

This document has been written to help in the choice of a configuration 
file parser library to be included in Verdandi, a scientific library for data 
assimilation. The main requirements are 

1. Portability: Verdandi should compile on BSD systems, Linux, MacOS, 
Unix and Windows. Beyond the portability itself, this often ensures 
that most compilers will accept Verdandi. An obvious consequence 
is that all dependencies of Verdandi must be portable, especially the 
configuration file parser library. 

2. The configuration file parser library should be written in C-|— 1-, possi- 
bly in C, to be called from Verdandi written in C+-|-. 

3. License: any dependency must have a license compatible with Verdandi 
licenses (GPL and LGPL). 

4. The library must provide the functionality of creating sections in the 
configuration file. 
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Part II 

Config 



Config 


Distribution 1 - May 2008 


Doc. updated in May 2008 


http : //www . codeproject . com/KB/f iles/conf ig-f ile-parser . aspx 


License: LGPL (GPL compatible) 


Language: C++ 



Main features 

- Configuration files may be sub-structured arbitrarily deep 

- Configuration files support the expansion of symbolic values from previ- 
ously defined variables and environment variables 

Portability: platforms and compilers supported 
Only standard C++ (code is cross platform) 

- MSVS Express 2005 project files are included 

- Manual build successfully tested with GNU g++/Linux 

Installation 
Limitations 

Sub groups less easy to create and read than with GetPot (requires an 
iterator on a STL map) 
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Part III 

GetPot 



GetPot 


Distribution 1.1.18 - Jul. 2008 


Doc. updated in Mar. 2007 


http : //getpot . sourcef orge .net/ 


License: LGPL (GPL compatible) 


Language: C++, Java, Python, Ruby 



Main features 

- Parses comand line arguments, single or multiple configuration files 

- Variables can be sorted into sections and subsections 

- Many features, such as unrecognized object detection (but I found a bug...) 
and prefixes allowing to focus on variables in a given section 

- Easy to use thanks to detailed, organized and commented example files 
(see: http : //getpot . sourcef orge .net/example .html) 

- Provides a language allowing a variety of operations on variables, numbers 
and strings inside a configuration file (recursive replacements, conglomer- 
ate variable names, dictionaries; concatenation and replacement in strings; 
power expressions, comparisons and conditions in numeric expressions (see 
example file: http://getpot.sourceforge.net/expand.htnil)) 

- The user can define and name its own variables (the parser finds them) 

- GetPot can be used to emulate trivial function calls (without syntax check- 
ing) 

- Several styles of comment available for configuration files 

- Emacs syntax highlighting for GetPot files 

- Provides a Python port 

- Non-military usage only, but civil applications are allowed even in a mili- 
tary context 

Portability: platforms and compilers supported 

Platform independent (istream problem with carriage return/newline on Mi- 
crosoft Visual Studio should be solved) 

Installation 

- Easy to install: contained in one single header file 

- Requires STL library 

Limitations 

- No exceptions thrown (for example, no error message when a file is not 
found; when numeric expressions have a wrong type, refer to non-existent 
variables), a default value is returned if a key is not found in the input file 

- Subsection definition is not intuitive and not fiexible if './' syntax is used, 
better to use only full subsection names 
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- Header and source not fully separated 
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Part IV 

libcfgparse 



libcfgparse 


Distribution 0.6 ~ Dec. 2005 


Doc. updated in Dec. 2005 


http : //f reshmeat . net/pro j ects/libcf gparse/ 


License: GPL (GPL compatible) 


Language: C 



Main features 

- C, C++ and Python API 

- Configuration file syntax is similar to C 

- Allows to keep data structured as lists and records; by this allows to 
group variables together to handle them conveniently 

- Built-in variable types: string, boolean, integer and floating-point 

- Allows pre-definitions of types and declaration of default values 

- Allows for strict type-checking 

- Allows to parse data directly from memory without a file 
Portability: platforms and compilers supported 

Installation 
Requires yacc and lex 

Limitations 

- Preliminary documentation 

- No maintenance, not in development 

- Requires yacc and lex (so designed for Unix operating system) 

- Written in C (but provides a C++ API) 
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Part V 

libconfig 



libconfig 


Distribution 1.3.2 - Feb. 2009 


Doc. updated in Feb. 2009 


http : //www .hyperrealm. com/libconf ig/ 


License: LGPL (LGPL and GPL compatible) 


Language: C++ 



Main features 

- A fully reentrant parser: independent configurations can be parsed in 
concurrent threads at the same time 

- Both C and C++ bindings, as well as hooks to allow for the creation of 
wrappers in other languages 

- A low-footprint implementation (just 38K for the C library and 66K for 
the C++ library) that is suitable for memory-constrained systems 

- Proper documentation 

Portability: platforms and compilers supported 

- Linux, Solaris and Mac OS X 

- Windows 2000/XP and later: gcc in the MinGW environment or with 
Visual Studio 2005 

Installation 



Limitations 

Configuration file syntax similar to C++ (quite heavy with {} and ; ) 
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Part VI 

libConfuse 



libConfuse 


Distribution 2.6 - Dec. 2007 


Doc. updated in 2004 


http : //www . nongnu . org/conf use/ 


License: LGPL (GPL compatible) 


Language: C 



Main features 

- Supports sections and (lists of) values (strings, integers, floats, booleans or 
other sections), as well as some other features (such as single/double-quoted 
strings, environment variable expansion, functions and nested include 
statements) 

- No myriads of features in a simple API making it easy to use and quick 
to integrate with one's code 

Portability: platforms and compilers supported 
Installation 



Limitations 
Written in C 
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Part VII 

Program_options 



Program_options 


Distribution 1.38.0 - ? 


Doc. updated in Nov. 2007 


http : //www .boost . org/doc/libs/l_38_0/doc/html/program_options .html 


License: Boost Software License (GPL compatible) 


Language: C++ 



Main features 

- Reads key/value pairs from command line, a configuration file and 
environment variables 

- Good documentation and tutorial 

Portability: platforms and compilers supported 
Any platform 

Installation 

Program_options is one of the Boost C++ Libraries 

Limitations 
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Part VIII 

RudeConfig 



RudeConfig 


Distribution 5.0.5 - released in ? 


Doc. updated in ? 


http : //rudeserver . com/conf ig/ 


License: GPL (GPL compatible) 


Language: C++ 



Main features 

- Independent core library designed for CGI (Common Gateway Interface) 

- Reads and writes configuration / .ini files 

- Provides fully customizable delimiters and comment characters, ensuring 
compatibility with most existing configuration / .ini file formats 

- Allows multiline values using backslash escapes 

- Comments within the configuration file are fully preserved when the 
contents are re-saved 

- Deleted values can become commented out when the object is re-saved, 
preserving old data 

- LGPL license can be provided by the author if needed 

Portability: platforms and compilers supported 
Borland, Visual C++ 6.0 and Linux 

Installation 



Limitations 
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Part IX 

Talos 



Talos 


Distribution 1.0 - Apr. 2007 


Doc. updated in Oct. 2004 


http : //vivienmallet . net/lib/talos/ 


License: GPL (GPL compatible) 


Language: C++ 



Main features 

Provides miscellaneous functions and objects, such as 

- Functions to deal with strings and files that C++ is missing 

- An extended ifstream class 

- Two classes to read flexible configuration files: one for a single configura- 
tion file and another for multiple configuration files 

The parser functionalities are: 

- Search for a word in the configuration file 

- Extracts the value of a field 

- Benefits from markup substitution 

- Exceptions may be thrown providing a string explaining what happened 

- Allows to apply a constraint on a value, or to force it to be part of a set 
of values 

- Very clear and fiexible configuration file syntax 

Portability: platforms and compilers supported 
Manages Windows end of line character 

Installation 



Limitations 
No subsection 
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Part X 

Other Libraries 

A Configuration Package : http : //alumni . media. mit . edu/~rahimi/conf iguration/. 

Limitations — Based on Lex and Yacc, no activity since 2001. 

ccl (Customizable Configuration Library) allows the comment, key/value 
and string literal delimiters to be programatically specified at runtime. 
Simple, portable with a small interface consisting of five functions : 
http : //sbooth . org/ccl/. 
Limitations — Written in C. 

CFL (Configuration File Library). Portable, requires GDSL library: 
http : //home . gna.org/cfl/. 

Limitations — Written in C. 

ConfigFile C++ portable code with templates: 

http : //www-personal . umich . edu/~wagnerr/ ConfigFile . html. 

Limitations — Impossible to define sections in configuration files. 

Configuration File Parser supports both shared as well as static bind- 
ing of binaries. Provides API for both manual and automatic processing of 
configuration file entries : http://sourceforge.net/projects/parser. 
Limitations — Written in C. 

ConfigParser reads and writes configuration files with a syntax similar 
to C/C++; after being read in a configuration file, the configuration data is 
available for access, modification and removal, or can also be written back 
to a file: http://www.codedread.eom/code.php#Config. 
Limitations — Not maintained, not portable (only Windows executable 
without source code). 

Confix : http : //www . f lipcode . com/archives/Conf iguration_File_Parser . shtml. 

Limitations — IBM Public license not compatible with GPL license. 

dot.conf : http://www.azzit.de/dotconf/. 

Limitations — Written in C, no activity since 2003. 

dotconfpp : http://ostatic.com/dotconfpp/. 

Limitations — Not portable (distribution FreeBSD for 1386). 
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GLib is a general-purpose utility library, which provides many useful 

data types, macros, type conversions, string utilities, file utilities, a main 

loop abstraction, and so on. It works on many UNIX-like platforms, 

Windows, OS/2 and BeOS. LGPL license. Provides a key-value file parser: 

http : //library . gnome . org/ devel/glib/unstable/glib-Key-value-f ile-parser . html. 

Limitations — Written in C. 

iniParser Simple, small, portable and robust ini file parsing library.: 
http : //ndevilla. f ree . f r/ iniparser/. 
Limitations — Written in C. 

Libconfig supports callback functions, automatic variable assignment : 
http : //www . rkeene . org/oss/libconf ig. 

Limitations — Written in C, not tested under Windows. 

libinifile : http://it.bmc.uu.se/andlov/proj/libinifile/. 

Limitations — Not portable (uses make to build the library under Unix) . 

liblcfg is a lightweight configuration file library. The file format supports 
arbitrarily nested simple assignments, lists and maps (aka dictionaries): 
http : //liblcfg . carnivore . it/. 
Limitations — Written in C99. 

ParseCfg : http://www.mentaljynx.com/CCpp/libs/parsecfg/. 

Limitations — Written in C, no good documentation, no activity since 2001. 

spConfig uses configuration files with an XML-like syn- 
tax with some additional preprocessor-style commands: 
http : //pr j . sof tpixel . com/spconf ig/. 
Limitations — Written in C, no activity since 2003. 

Templatized Configuration File Parser (TConf) is inspired by 
the TCLAP project (Templatized C-|— |- Command Line Parser Library: 
http : //tclap . sourcef orge .net/). TConf is a smaller configuration parser 
library and can be used in combination with TCLAP. Released in Aug. 2007 
under GPL license: http://tconf.sourceforge.net/. 
Limitations — No sections in configuration files. 

TCFP (Tiny Config File Parser library) is small, fast and simple: 
http : / / sourcef orge . net/pro jects/tcf p/. 

Limitations — Pre-alpha version, written in C99. 



13 



